Get Specific Customer Details

This request retrieves the details of a specific customer. Once the customer has been created, retrieve it to verify the details.

URI

Copy

{{baseUrl}}/api/v2/customer/{CustomerGuid}/user

HTTP Method

GET

Request Parameters

Parameter

Type

Description

CustomerGuid

string ($uuid)

umpCustomerGuid created in the Live Platformcustomer tenant SQL database :

■

Operator Connect: A new OC Essentials service is created when a license is applied to the lead using Create Customer from Lead Overview). If this field is null, a license has not yet been applied to the lead.

■

Direct Routing: A new Hosted Essentials service is created by Create Essentials Customer.

This value is also retrieved using Get Services Brief Details (V3) and Get Customers Brief Details (V2) and in the 'Get Task' response when the customer service is created.

Example Response

●

Single Site:

Copy

{
    "Id": "2ada8357-5cb2-4ba7-8aa8-d9c2cab19af6",
    "ShortName": "BB175Pro",
    "FullName": "BB175Pro",
    "LicenseType": 2,
    "SiteLocation": [
        {
            "id": "2ada8357-5cb2-4ba7-8aa8-d9c2cab19af6",
            "name": "BB175Pro",
            "sbcId": 5,
            "sbcDeploymentState": "Deployed"
        }
    ]
}

●

Multiple Sites:

Copy

{
    "Id": "2ada8357-5cb2-4ba7-8aa8-d9c2cab19af6",
    "ShortName": "BB175Pro",
    "FullName": "BB175Pro",
    "LicenseType": 2,
    "SiteLocation": [
        {
            "id": "2ada8357-5cb2-4ba7-8aa8-d9c2cab19af6",
            "name": "BB175Pro",
            "sbcId": 5,
            "sbcDeploymentState": "Deployed"
        },
        {
            "id": "576c0ab0-a76b-4ac4-9077-c791d74ca382",
            "name": "SouthSite",
            "sbcId": 5,
            "sbcDeploymentState": "Deployed"
        }
    ]
}

HTTP Responses

■

200 OK

Parameter

Type

Description

string($uuid)

'umpCustomerGuid' value created in the Live Platformcustomer tenant SQL database directory:

■

Direct Routing: A new Hosted Essentials service is created by Create Essentials Customer.

This value is also retrieved using Get Services Brief Details (V3) and Get Customers Brief Details (V2) and in the 'Get Task' response when the customer service is created.

shortName

string

Short name of service complying with the following validation rules:

■

The string should be 3-15 characters long

■

The following characters cannot be used: \ / : * ? " < > |audit

■

Can contain letters (lower/UPPER case), Numbers and special characters are allowed, however cannot contain the dot (.) or blank spaces.

■

Unique name per M365 Tenant

fullName

string

The customer full name defined in the customer's Operator Connect JSON file.

licenseType

integer Enum:

[3, 4, 5]

[ 0, 1, 2]

One of the following values:

■

Hosted Essentials: 0

■

Hosted Essential Plus: 1

■

Hosted Pro: 2

■

OC Essential: 3

■

OC Essential Plus: 4

■

OC Pro: 5

licensedUsersCount

integer

Number of licensed users.

msTenantId

string

Microsoft subscription Tenant ID of the customer attached to the service.

siteLocation (SIP Connection)

Array including the following:

■

id: string($uuid)

■

name: string

■

sbcId: integer

■

sbcDeploymentState: string

The configured SBC used to manage calls for this SIP Connection.

string($uuid)

This value is identical to 'umpCustomerGuid' if a single site exists and is unique if additional sites are defined.

name

string

Name of the SIP Connection.

sbcId

integer

Id of the SBC device in the Live Platform SQL database (see Get SBC Devices.

sbcdeploymentState

string

Deployment state of the tenant. One of the following values:

■

Draft=0

■

Submitted=1

■

Deploying=2

■

Deployed=3

■

Error=4

■

ReadyForDeployment=5

■

ReadyForRemove=6

■

Removing=7

■

Removed=8